home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.3 / SetClass.3 < prev    next >
Encoding:
Text File  |  1995-07-26  |  3.2 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      TTTTkkkk____SSSSeeeettttCCCCllllaaaassssssss((((3333))))               TTTTkkkk (((( ))))                TTTTkkkk____SSSSeeeettttCCCCllllaaaassssssss((((3333))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           Tk_SetClass, Tk_Class - set or retrieve a window's class
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           ####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
  15.  
  16.           TTTTkkkk____SSSSeeeettttCCCCllllaaaassssssss(_t_k_w_i_n, _c_l_a_s_s)
  17.  
  18.           Tk_Uid
  19.           TTTTkkkk____CCCCllllaaaassssssss(_t_k_w_i_n)
  20.  
  21.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  22.           Tk_Window   _t_k_w_i_n    (in)      Token for window.
  23.  
  24.           char        *_c_l_a_s_s   (in)      New class name for window.
  25.      _________________________________________________________________
  26.  
  27.  
  28.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.           TTTTkkkk____SSSSeeeettttCCCCllllaaaassssssss is called to associate a class with a particular
  30.           window.  The _c_l_a_s_s string identifies the type of the window;
  31.           all windows with the same general class of behavior (button,
  32.           menu,  etc.)  should have the same class.  By convention all
  33.           class names start with a capital letter, and there exists  a
  34.           Tcl  command with the same name as each class (except all in
  35.           lower-case) which can  be  used  to  create  and  manipulate
  36.           windows   of   that  class.   A  window's  class  string  is
  37.           initialized to NULL when the window is created.
  38.  
  39.           For main windows, Tk automatically propagates the  name  and
  40.           class  to  the  WM_CLASS  property  used by window managers.
  41.           This happens either when a main window is  actually  created
  42.           (e.g. in TTTTkkkk____MMMMaaaakkkkeeeeWWWWiiiinnnnddddoooowwwwEEEExxxxiiiisssstttt), or when TTTTkkkk____SSSSeeeettttCCCCllllaaaassssssss is called,
  43.           whichever occurs later.  If  a  main  window  has  not  been
  44.           assigned  a class then Tk will not set the WM_CLASS property
  45.           for the window.
  46.  
  47.           TTTTkkkk____CCCCllllaaaassssssss is a  macro  that  returns  the  current  value  of
  48.           _t_k_w_i_n's class.  The value is returned as a Tk_Uid, which may
  49.           be used  just  like  a  string  pointer  but  also  has  the
  50.           properties  of  a unique identfier (see the manual entry for
  51.           TTTTkkkk____GGGGeeeettttUUUUiiiidddd for details).  If _t_k_w_i_n has not yet been  given  a
  52.           class, then TTTTkkkk____CCCCllllaaaassssssss will return NULL.
  53.  
  54.  
  55.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  56.           class, unique identifier, window, window manager
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/23/95)
  64.  
  65.  
  66.  
  67.